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INTRODUCTION 

GENERAL 


o-oo mM 


TAPECOPY is a general-purpose utility program used to duplicate» 
compare» merges or concatenate nonslibrary»  wulti-file © or 
single-file tapes. It allows the user to selectively delete any of 
the files to be processed or to produce multipte copies of a 
copied» merged» or concatenated tape. It accepts input files 
coming from either tape or disk. | , | 


Note that ANSI standards do not altow a blank file-id on a multi- 
file tape. However» a blank file-id is allowed on a. single-file 
tapes. Ps ae , fe — 


TAPECOPY will not accept library (LOAD.DUMP) tapes. For similar 
activities involving LOAD.DUMP tapess the user must use SYCOPY.. 
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OPERATING INSTRUCTIONS 
When executed» TAPECOPY. disptays: 
ENTER <ACTION: CPY» CMP» CCM» MRG OR CAT> a 
<DEVICE: TCAPE) OR DCISK)> <TAPE COUNT> 
The user must respond withs 


<amixtindex> AX <action> [<device>] [<integer>] 


DEVICE 


The <DEVICE> may be gienae TCAPE) or DCESK)» with TAPE being the 


defauit. If DISK» the system pack is assumed» untess the user has 
file-equated DISK.FILE to a non-blank packvid. For example» if the 
user had specified "?FI DISK.FILE PACK.ID MYPACK3"»5 TAPECOPY would 
assume the desired pack is Labeled "MYPACK". — | =. 


TAPE COUNT 


From one to seven tapes may be specified as output. If the 


<CINTEGER> entry is omitteds then one tape is assumed. 
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ACTION 


There are five possible actions: 


CPY  $Create <INTEGER> copies of the source tape or 
famity of disk files» with no compare. If tapes 
the input tape should have a default file~id of 
SOURCE» but any tape may be [L~-ed to the request. 
If disk» the files should have a default 
multifile-id of SYS. This may be modified by 
file-equating the file named ODISK.FILE to the 
multifile-id desired by the user (See DISK FILE 
INPUT on pe 2°5)4 The specified pack wiil then be 
searched for all files with this multifitle-id. 
Ait output file-id*s are identical to the input 
filerid*'s. All output multifilerid'’s are 
identical to to the input multifile-id» unless an 
output tape has been filerequated (See RENAMING 
QUTPUT TAPES on pe 2°5). > _ 


CMP Compare <INTEGER> tapes with the source tape or 
| family of disk files. If any tape faits to 
compares that unit 1s LOCKed and the user is 
notified via the SPO. TAPECOPY continues to 
compare the remaining tapes. If tape» the source 
tape has an expected filtesid of SQURCEs if disk» 
the files have a default multifile-id of SYS (See 
CPY above). The tapes to be compared have an 
expected file-id of OUT.SYS» but any tapes may be 
IL-ed to the requests. Tapes having aifferent 
file-id's or record tengths than the source’ tape 
may be successfudly compared. File names are not 
checked» so tapes having different multifile-id’s 
or file-id*'s will pass the comparison if the 
contents of the files are the same. When the 
files being compared have different record 
lengths» the shorter record is considered to be 
right-fitted with blanks for the purpose of the 
comparison. Thus» files with different record 
lengths will pass the comparison if the contents 
of the files are the same except for trailing 
bianks. | _ | 7 | 
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CCM 


MRG 


CAT 


ans 


Create <INTEGER> copies of the source tape or 


disk file familys and compare all copies with the 
original. If any copied tape is not identical to 
the original» that tape is PURGEdG and the user 


notified via the SPO. TAPECOPY continues to. 


compare the remaining tapes. If tape» the source 
tape should have a default file-id of SOURCES tf 


6 disk» the files should have a default 


mudtafile-id of SYS (See CPY above). ALi output 
file-id's are identicat to the input filecrid‘s. 
ALL output multifile-id's are identical to the 
input multifile-id» unless an output tape. has 
been ripereauares (See RENAMING OUTPUT TAPES = on 
De 275)- 


Merges the files from a source tape with either 
(a) the files on a second tapes» or (b) a family 
of disk files. It creates <INTEGER> numder of 
copies» atl having the same multifile-id as the 


source tape unless an output tape has been 


file-equated (See RENAMING OUTPUT TAPES on pe 
275)- = 


The source tape has an expected file-id of 
SOURCE. The update tape has an expected fiierid 
of UPDATE. Both tapes may be Iblred to the 
request. If the update files are = on disk» they 
are assumed to have the same multifile~id as the 
source tape untess DISK.FILE has been 
file-equated (See DISK FILE INPUT on pe. 276). The 
specified disk is searched for alt files having > 
this multifite-id» and these files are used = as 
the update files. Dupticate files are eliminated» 
with the update file having precedence over the | 
source file. 


The input files wilt concatenated into one 
tape files with anaas coptes Cif requested). 


The output tape file will have the same name = as 


the first input file» unless the output tape has 
been file-equated (See RENAMING OUTPUT TAPES on 
pe 275)- | 


TAPE INPUT Input tape files are expected to have 
a cee id of NEXTFILE > but any tape 
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may be IL-ed to the request. Onty the 
first fite on each tape is used» then 
the unit is LOCKed and another tape. 
is requested. This continues until 
the user responds to a file request 
with the optional file statenent: 


<mixeindex> AX OF 


Input disk files are expected to have 
a multifilecrid of SYS» though this 
may be modified by file-equating§ the 
file named DISK.FILE to the desired 
multifile~id (See DISK FILE INPUT on 


pe 275). The message 


ENTER FILE 10 OF NEXT FILE 


wiil appear on the SPO for each 0of 
the files to be concatenated. The — 
user must ACCEPT with the file-id of 
the desired file: 


<mix-index> AX <file-id> 


A blank accept message terminates the 


concatenation process» so the user. 
must use quotes to enter a blank 
file-id. If the name is invalid» or. 
the file cannot be founds, an 
appropriate message will be displayed 
on the SPQ and the user. should 
re-enter the correct name. If SH 2 

1» the names wilt be in a card file | 
labelled TCARODS (with one name per. 


card.) 
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At the completion of processings TAPECOPY will. display the 
following message: : | | 


<integer> TAPECS] <action taken> © 
followed by | 
<integer> TAPE{S] [FAILED TO COMPARE or PURGEDJ 


if any tape(s) failed to compare or were purged. 


OPTIONAL FEATURES 


on dh: an a an mn he a a ee 


CARD FILE SPECIFICATIONS 


SQM ORD wena Banana ne aa 


Normaily» TAPECOPY interfaces with the user via the SPO. However>s 
if SW 3 = 1» TAPECOPY will expect all commands in a card file 
labeted TCARDS. Each card is treated as a single accept messages 
and no command prompts will appear on the SPO. SWitch 3 wilt. 
override the settings of SWitches 1 and 2» so that atl input is 
from cards. If any card is incorrect» an appropriate error message 
wilt appear on the SPOsfollowed by the message 


PLEASE CORRECT CARD AND REEXECUTE--TAPECOPY ABORTED 
TAPECOPY wiil terminate and the user should reexecute the program 


using the corrected card deck. If end-of-file is reached white 
looking for a card» the message : 


INPUT SPECIFICATION CARD MISSING 
wilt be displayed on the SPQ. The card file will be reopened» and 


the user should read in a file labeled TCARDS which contains the 
remaining specification cards. 
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RENAMING QUIPUT TAPES 


TAPECOPY allows the user to change the name of each duplicated, 
merged» or concatenated tape through file equation. Tape number 
CTAPE.<n>) is equated to name (NAME <tapename>) for each copy 
desired with that name. If no new name is specified» the default 
output tape label witl be the same as the input tape tabel. 
Muitiple copies may contain a mixture of default and specified 
names» for up to seven tapes. | | 


Example: 


PEX ‘TAPECOPY | | 

2FI TAPE.1 NAME NEW. TAPES. 
?FI TAPE.2 NAME DUP .TAPES 
TEND 


After the sample deck is entered ‘through the card reader» TAPECOPY 
will then ask for an operator response (See OPERATING 
INSTRUCTIONS) and perform the requested action» tiabelling the 
mergeds copieds or concatenated output tapes as NEW.NAME and 
DUP.TAPE. If the user had requested seven copies» the five other 
tapes in that execution would have had default Cinput 
multifite-id) tabels. : : | | | 


DISK FILE INPUT 


2B One 2B E henna ae 


If <device> is DCISK)» TAPECOPY wilt accept input files from disk. 
The files are assumed to be on the system pack» with a default 
multifile-id of SYS (Cor of the source tape in the case of a 
merge). The disk pack-id or multifile-id can be changed ‘by 
file-equating DISK-FILE to the desired name» as in the following 
example. | 


aah ashih pu Tialds bet ioc 
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Exaaptes _ 


9 EX TAPECOPY tf | 
2? FI DISK.FILE NAME MYPACK/ NEW. MFIO/3 
? END 


With proper changes: this execution could have also. been done = on 


TAPECOPY now expects all input disk files to be. ere on the pack 
MYPACK and to have a multifile-id of NEW. MFIDs In a copy» compares 
or merges the disk directory will be searched for all files with 
the muitifile-id of NEW.MFIDs and these files witl be used as 
input. In a concatenations the user will be asked to specify the 
file-id*s of the files to be concatenated. | 


DELETE FILES 


If SWitch i is set» then the user can specify that certain files be 
ignored (deleted in a copy or merge and skipped over in a 
compare). SW iis set to "1" if the file names are to be read from 
a card file tabelled TCARDS and to "2" if the names are to be 
entered from the SPO Ce.ege» 27EX TAPECOPY SW 1 = 2). Notes» however>s 
that SWitch 3, if sete witt override pneee settings (See CARD ‘FILe 


The names must be waiter file-ids. Special characters must be 
enclosed in quotes. CO 3 he po c. 


The files are assumed to have the same. pack-id Cif disk) and 
 multifite-id as the input unit. If an invalid name .is read» = an 
error message will appear on the SPO. | 7 


FROM CARDS Only one file-id per card is allowed. A btank 
card or EOF. signals that there are no more 
names to be read. If an invalid name 1s 

found» an appropriate error message will 
appear on the SPO» - and TAPECOPY witl 
terminate after displaying the message: | 


stash came ga anand 
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PLEASE CORRECT CARD AND REEXECUTE =~ 


TAPECOPY ABORTED 


FROM SPO = The 


message. A blank ACCEPT 


message 
the name~entry process: 


<mix~eindex> AX 


PRINT FEATURES 


a a a on a ot mama a 


1)» 
taken. It 


When the print option is set (SW 0 = 
record of files accessed and actions 
names 


the name of each tape or disk file accessed» and 


user must enter a singte name per 


TAPECOPY will 


of att files the user requested deleted. It 


ACCEPT 
terminates 


produce a 
wilt print the 
Kill also print 
whether or not 


that file was copied» compared» or skipped. Example: 


wenake FILES TO BE DELETED kkk 
~TAPECOPY2 

kkekkikhkhetk COPY FILES ««xnnxnennnn 
SNORMAL COPIED | 

TAPECOPY2 SKIPPED 

NIF COPIED 

kkKKKKKK COMPARE FILES «%xxxu%% 
SNORMAL COMPARED 

TAPECOPY2 SKIPPED ON SOURCE. 
NIF COMPARED 


** 1 TAPE COPIED AND COMPARED ** 


Fig. 261 


Example of Printed Qutput 
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SWITCH SETTINGS 


All defautts are zero for the following program switches: 


Switch 0 


0 - No printer output 


is Prints a summary of actions taken | 


Switch 1 


o- No files to be deleted 


TAPECOPY 


2219 0110 


i- rue ewes of files to be deleted will be read 


from YTCARDS 


od The names of fites to be deleted witl be read 


from the SPQ 


Switch 2 


Ye ew © PP 2 Ye 


0 - The names of disk files to be concatenated _ 


will be read from the SPO. 


i-  £xThe names of disk files to be concatenated 


will be read from the card file TCARDS 
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Switch 3 
ha ananehan a 
0- Specifications will be read from the SPO 


1 


ALL specifications and file names wilt be 


read from the card fite  TCAROS. ~~ This 
overrides SWitches 1 and 2. 
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FILE NAME CONVENTIONS 


om ab an an am an ab Gn OO OD On dn in a OD Dm ah me oe 


TAPECOPY uses the following files: 


EXTERNAL NAME INTERNAL NAME DEVICE. 


SOURCE SOURCE.TAPE | Tape 

UPDATE UPDATE.~TAPE Tape 

SYS S CISKeFILE Disk 

OUT.SYS TAPE ol» « « « Tape 
TAPE .7 


TCARDS TCARDS © Cards 
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ERROR MESSAGES 


TAPECOPY produces two types of error messages» denending on the 
error (non-fatal or fatal). Non-fatal error messages are warnings 
that require an additional response or are for the user's 
information. For non-fatal DISK READ PROBLEMS» it is suggested 
that the user DS the current job and execute it again with SWitch 
1 set to "1" so that a printed record of all activities will be 
availabie. The other alternatives checking output tapes. for 
missing files» is considerably less reliable. Fatal errors require 
that the job be run agains 


NON-FATAL ERRORS 


Processing will continue after one of the foliowing messages is 
received. Except for the tast two messages» which are solely for 
the users information» all require user response for proper 
execution of the program. 


* INVALID ACTION -- <input message> | 
CACTION must be CPY> CMP» CCM» MRG or CAT.) 


* INVALID DEVICE OR TAPE COUNT == <input message> | 
(DEVICE must be DCISK) or TCAPE) or blank. TAPE COUNT must be 
between "1" and “7"» or blank.) 7 | om 


* [INVALID NAME -~ <error message> *- <input name> _ 
COne of the following: EMBEDDED BLANKS NOT ALLOWED> CAN HAVE AT 
MOST 10 CHARACTERS» UNMATCHED QUOTE» or BLANK FILE"IO NOT 
ALLOWED.) | | 


* <unit-id> IS LIB TAPE -- MUST. EXECUTE SYCOPY FOR LOAD.DUMP 
TAPES 
COnly non-Library multifile tapes may be ised with TAPECOPY. The 
tape unit is closed with LOCK» and the OPEN is reissued.) 
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* <unit-id> HAS ONLY ONE NAME -- MUST HAVE NON“BLANK FILE“ID FOR 
A MERGE | | 5 
CANSI standards will not allow a blank file-id on a multi-filte 
tape. The tape unit is closed with LOCK» and the OPEN is 
reissued.) 7 | 


* FILE <file-name> NOT FOUND 
(When concatenating disk files» the specified file could not be 
found. Re~enter the correct name.) | 


* INVALID RESPONSE . | , 
(The prompt is reissued» Listing valid responses.) 


* DISK READ PROBLEMS == ALL FILES MIGHT NOT HAVE BEEN FOUND =- 
TAPECGPY CONTINUED : F.. 
(Disk was specified in a copy» compare or merge and disk read 
probleas $$were encountered during the search of the disk. 
directory for the file names. It is possible that not all of. 
the fites were found. It is ‘suggested that the user re~execute 
the program unless SWitch i was set.) 


* COMPARISON ERROR ON <unit- aids 
(This tape did not match the original. > 


FATAL ERRORS 


= op anh ah GP om WP a an ap an ie 


Each of the following error. messages re with? 
“= TAPECOPY ABORTED 


The first part of the SPO message corresponds to one of the 
following errors: | | 3 7 | 


» C€DISK READ PROBLEMS--2 <pac k naime>/<fanily name>/= NOT FOUND 

(No files with the specified family name were found. If DISK READ 
PROBLEMS is part of the message» disk read problems were 
encountered during the search of the disk directory for the files» 
$0 it is possible that there are files with the specified family 
name on disk. It is suggested that the user resexecute the 
orogram.) | 7 : a 
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& ginceuers CHARACTER RECORD LENGTH. Is. GREATER THAN 2000 
(The maxinue record size of 2000 characters was exceeded.) 


* <integer> CHARACTER RECORD LENGTH IS LESS THAN 8 
(The MCP will not allow tapes with a record size less than 8 
characters) : 7 


* RECORD LENGTH OF <integer1> CHARACTERS. Is. GREATER THAN INITIAL 
RECORD LENGTH OF <integer2> 

(When concatenating files» no file may have a record Length neater 

than that of the first file.) 


* NO FILES CCOPIED»s MERGED» CONCATENATED)» NO TAPES CREATED 
(No tapes were created. The user specified that all files were to 
be deleted.) 


* PARITY ERROR ON <unit-id> | | 
(The specified input file had a parity error.) 
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